VCard Maker
1. Introduction
The VCard Maker renders a clean, scannable contact card (SVG) from standard vCard 3.0 text. It’s great for team directories, speaker bios, internal wikis, and handoff documents. You write a tiny vCard block; DocOps turns it into a polished card with name, role, organization, phones, emails, and a compact QR code linking back to the card data.
2. Usage
Insert a block using the docops extension and the vcard type. For reusability, keep your vCard content in data files and include them.
[docops,vcard]
----
BEGIN:VCARD
VERSION:4.0
FN:Jordan A. Rivera
N:Rivera;Jordan;A.;Mr.;
ORG:Acme Solutions;Product Engineering
TITLE:Senior Engineering Manager
ROLE:Engineering Management
EMAIL;TYPE=work,preferred:jjrivera@acmesolutions.com
EMAIL;TYPE=personal:jordan.rivera@gmail.com
TEL;TYPE=work,voice,preferred:+1-415-555-0123
TEL;TYPE=work,fax:+1-415-555-0140
TEL;TYPE=cell:+1-415-555-0199
TEL;TYPE=home:+1-415-555-0166
ADR;TYPE=work;LABEL="Acme Solutions\n123 Market St\nSuite 400\nSan Francisco, CA 94105\nUSA":;;123 Market St;San Francisco;CA;94105;USA
ADR;TYPE=home;LABEL="Home\n456 Oak Ave\nApt 2B\nOakland, CA 94607\nUSA":;;456 Oak Ave;Oakland;CA;94607;USA
URL;TYPE=work:https://www.acmesolutions.com
IMPP;TYPE=work:xmpp:jrivera@acmesolutions.com
X-SOCIALPROFILE;TYPE=twitter:https://twitter.com/jordanrivera
X-SOCIALPROFILE;TYPE=linkedin:https://www.linkedin.com/in/jordanrivera
X-SOCIALPROFILE;TYPE=facebook:https://www.facebook.com/jordan.rivera
BDAY:1985-07-14
REV:2025-11-07T12:00:00Z
NOTE:Primary contact for product engineering and cross-functional initiatives.
END:VCARD
----
2.1. Default
2.2. Business Card
2.3. Tech Pattern
3. Designs
The VCard Maker supports multiple design templates and a light/dark theme. Choose a design via a small config header placed before your vCard content, separated by ---.
Supported designs:
-
tech_pattern_background — Tech motif background with contrast blocks; pairs well with theme=dark
-
business_card_design — Classic business look (default if not specified)
-
business_card_design2 — Modern variant of the classic business card
-
business_card_template — Minimal template with clear information areas
-
creative_agency_pro_contact_card — Playful, agency-style layout with bold accents
-
modern_card — Contemporary, airy layout with generous spacing
Themes:
-
theme=light (default)
-
theme=dark
Example selector usage:
[docops,vcard]
----
design=tech_pattern_background
theme=dark
---
BEGIN:VCARD
VERSION:4.0
FN:Jordan A. Rivera
N:Rivera;Jordan;A.;Mr.;
ORG:Acme Solutions;Product Engineering
TITLE:Senior Engineering Manager
ROLE:Engineering Management
EMAIL;TYPE=work,preferred:jjrivera@acmesolutions.com
EMAIL;TYPE=personal:jordan.rivera@gmail.com
TEL;TYPE=work,voice,preferred:+1-415-555-0123
TEL;TYPE=work,fax:+1-415-555-0140
TEL;TYPE=cell:+1-415-555-0199
TEL;TYPE=home:+1-415-555-0166
ADR;TYPE=work;LABEL="Acme Solutions\n123 Market St\nSuite 400\nSan Francisco, CA 94105\nUSA":;;123 Market St;San Francisco;CA;94105;USA
ADR;TYPE=home;LABEL="Home\n456 Oak Ave\nApt 2B\nOakland, CA 94607\nUSA":;;456 Oak Ave;Oakland;CA;94607;USA
URL;TYPE=work:https://www.acmesolutions.com
IMPP;TYPE=work:xmpp:jrivera@acmesolutions.com
X-SOCIALPROFILE;TYPE=twitter:https://twitter.com/jordanrivera
X-SOCIALPROFILE;TYPE=linkedin:https://www.linkedin.com/in/jordanrivera
X-SOCIALPROFILE;TYPE=facebook:https://www.facebook.com/jordan.rivera
BDAY:1985-07-14
REV:2025-11-07T12:00:00Z
NOTE:Primary contact for product engineering and cross-functional initiatives.
END:VCARD
----
4. Examples
4.1. 1) Product PM (basic)
[docops,vcard]
----
BEGIN:VCARD
VERSION:4.0
FN:Jordan A. Rivera
N:Rivera;Jordan;A.;Mr.;
ORG:Acme Solutions;Product Engineering
TITLE:Senior Engineering Manager
ROLE:Engineering Management
EMAIL;TYPE=work,preferred:jjrivera@acmesolutions.com
EMAIL;TYPE=personal:jordan.rivera@gmail.com
TEL;TYPE=work,voice,preferred:+1-415-555-0123
TEL;TYPE=work,fax:+1-415-555-0140
TEL;TYPE=cell:+1-415-555-0199
TEL;TYPE=home:+1-415-555-0166
ADR;TYPE=work;LABEL="Acme Solutions\n123 Market St\nSuite 400\nSan Francisco, CA 94105\nUSA":;;123 Market St;San Francisco;CA;94105;USA
ADR;TYPE=home;LABEL="Home\n456 Oak Ave\nApt 2B\nOakland, CA 94607\nUSA":;;456 Oak Ave;Oakland;CA;94607;USA
URL;TYPE=work:https://www.acmesolutions.com
IMPP;TYPE=work:xmpp:jrivera@acmesolutions.com
X-SOCIALPROFILE;TYPE=twitter:https://twitter.com/jordanrivera
X-SOCIALPROFILE;TYPE=linkedin:https://www.linkedin.com/in/jordanrivera
X-SOCIALPROFILE;TYPE=facebook:https://www.facebook.com/jordan.rivera
BDAY:1985-07-14
REV:2025-11-07T12:00:00Z
NOTE:Primary contact for product engineering and cross-functional initiatives.
END:VCARD
----
[docops,vcard]
----
design=creative_agency_pro_contact_card
BEGIN:VCARD
VERSION:4.0
FN:Jordan A. Rivera
N:Rivera;Jordan;A.;Mr.;
ORG:Acme Solutions;Product Engineering
TITLE:Senior Engineering Manager
ROLE:Engineering Management
EMAIL;TYPE=work,preferred:jjrivera@acmesolutions.com
EMAIL;TYPE=personal:jordan.rivera@gmail.com
TEL;TYPE=work,voice,preferred:+1-415-555-0123
TEL;TYPE=work,fax:+1-415-555-0140
TEL;TYPE=cell:+1-415-555-0199
TEL;TYPE=home:+1-415-555-0166
ADR;TYPE=work;LABEL="Acme Solutions\n123 Market St\nSuite 400\nSan Francisco, CA 94105\nUSA":;;123 Market St;San Francisco;CA;94105;USA
ADR;TYPE=home;LABEL="Home\n456 Oak Ave\nApt 2B\nOakland, CA 94607\nUSA":;;456 Oak Ave;Oakland;CA;94607;USA
URL;TYPE=work:https://www.acmesolutions.com
IMPP;TYPE=work:xmpp:jrivera@acmesolutions.com
X-SOCIALPROFILE;TYPE=twitter:https://twitter.com/jordanrivera
X-SOCIALPROFILE;TYPE=linkedin:https://www.linkedin.com/in/jordanrivera
X-SOCIALPROFILE;TYPE=facebook:https://www.facebook.com/jordan.rivera
BDAY:1985-07-14
REV:2025-11-07T12:00:00Z
NOTE:Primary contact for product engineering and cross-functional initiatives.
END:VCARD
----
4.2. 2) Research Scientist (multiple channels)
[docops,vcard]
----
BEGIN:VCARD
VERSION:3.0
FN:Aria Nova
N:Nova;Aria;L.;Dr.;PhD
ORG:Stellar Labs
TITLE:Principal Research Scientist
TEL;TYPE=cell,voice:+1-415-555-0420
TEL;TYPE=work,voice:+1-415-555-0421
EMAIL;TYPE=internet:aria.nova@stellarlabs.ai
EMAIL;TYPE=internet:research@stellarlabs.ai
URL:https://aria.nova.example.org
NOTE:Explores human-AI collaboration at planet scale. Loves synthwave and telescopes.
END:VCARD
----
4.3. 3) Minimal contact
[docops,vcard]
----
BEGIN:VCARD
VERSION:3.0
FN:Mo Lee
N:Lee;Mo;;;
EMAIL;TYPE=internet:mo@example.net
END:VCARD
----
4.4. 4) International profile
[docops,vcard]
----
BEGIN:VCARD
VERSION:3.0
FN:Sofia García
N:García;Sofia;;;
ORG:Globex Internacional
TITLE:Directora de Producto
TEL;TYPE=cell,voice:+34 600 123 456
EMAIL;TYPE=internet:sofia.garcia@globex.es
ADR;TYPE=work:;;Calle de Alcalá 123;Madrid;Madrid;28009;España
URL:https://globex.es/people/sofia
NOTE:Habla Español, Inglés y Portugués. Amante del café y de los mapas antiguos.
END:VCARD
----
5. Attributes
-
design: Optional; selects the visual template. One of:
-
tech_pattern_background,
-
business_card_design,
-
business_card_design2,
-
business_card_template,
-
creative_agency_pro_contact_card,
-
modern_card. Defaults to business_card_design when omitted or invalid.
-
-
theme: Optional; light or dark. Defaults to light.
-
scale: Optional numeric factor to scale the rendered SVG. Defaults to 1.0.
Notes on styling: - Colors, typography, and layout follow the chosen design and theme. Designs may emphasize different typography, spacing, or accents, while theme adjusts contrast.
6. Tips for great cards
-
Prefer FN (Formatted Name) and N (structured name) together so names render crisply and sort correctly.
-
Keep TITLE concise (e.g., Principal Engineer vs Principal Engineer — Platform Reliability) and move details to NOTE.
-
Include at least one EMAIL or TEL; the card will adapt gracefully if one is missing.
-
Use URL to link a profile or docs page; the QR encodes the vCard so mobile users can save the contact quickly.
7. Notes
|